home *** CD-ROM | disk | FTP | other *** search
/ Aminet 52 / Aminet 52 (2002)(GTI - Schatztruhe)[!][Dec 2002].iso / Aminet / comm / mail / YamHTMLyam.readme < prev   
Text File  |  2002-11-09  |  7KB  |  138 lines
  1. Short:   Reads HTML pages with YAM mail client
  2. Author:  Rodolfo Ignazi rodign@inwind.it or rodign@tiscali.it
  3. Version: 1.8a
  4. Type:    comm/mail
  5. Name:    YamHTML.yam or .rx
  6. Legal:   FreeWare
  7.  
  8. Some info about my Arexx script:
  9. It is used for reading HTML pages and embedded images (if there are) downloaded
  10. along with e-mails using YAM mail client for Amiga. It uses various amiga browsers.
  11.  
  12. Note For All Users:
  13. I am very interested to have emails which gives you some problem (if they are not
  14. private issues), I need them to test the script and, hopefully, find out the problem.
  15. A brief description of the problem would be useful.
  16. If you send me the emails it's better to send them as attachments in raw format.
  17. To get a raw format you may use save from the YAM message menu when you are on the
  18. reading window.
  19.  
  20. 1.8a note:
  21. Sometimes (rarely) it did not recognized HTML files if they were placed as
  22.  the body of the mail.
  23. It did not displayed images if there were one or more spaces on their names.
  24.  
  25. 1.8 note:
  26. The icon driven batch file for the configuration now sets all the parameters.
  27.  (It may be used instead of editing the first script lines 3 to 7 because it
  28.   overrides this internal setting -see next Note-).
  29. The option to choose between being asked or not when displaying an html page is now
  30.  simplified by a sheer yes or not that also can be set by the batch file.
  31. Adapted the documentation to this new version. I hope it's clear enough.
  32.  
  33. 1.7c-d Note: (Not pubblic.)
  34. Among other fixes, resolved a bug which blocked Yam if a bad configuration.
  35. Added an icon to click to easily configure for the browser to be opened and the
  36.  in new window option. It writes an local environment variable called yam0html which
  37.  when exists the program overrides the configuration on its first lines and don't
  38.  ask you for the browser of your choice.
  39. Remember that the prog always uses an already running browser regardless of
  40.  the configuration. And if you like to use Voyager you must start it first manually,
  41.  read on for more details. The "in new window" option is valid for Voyager too.
  42.  
  43. 1.7b Note:
  44. Added a control on a never happened event ( but who knows ? ). and another minor but
  45. useful change.
  46. For Boing Bag 3.9-2 users: It may happen that AWeb, if opened on its own screen,
  47. remains stuck to the front and can only be dragged down.
  48. It depends of the new exec.library, the cure is:
  49. SetPatch SKIPROMUPDATES  exec.library
  50. on the startup-sequence.
  51.  
  52. Installing has been updated to 1.8.
  53. Installing: 
  54. First of all you'll have to edit the first script lines 3 to 7 to set
  55. your browsers paths and names and the other two options, modifying the preset
  56. lines to your needs.
  57. Don't use MultiView as Default it don't unlock files, use SimpleHtML instead.
  58.  
  59. There are two ways for installing it:
  60. 1)
  61.   » Copy the file YamHtml.yam into the Rexx directory inside YAM:.
  62.   » Start YAM and press config button or select Configuration from the
  63.     Settings menu.
  64.   » Click on Arexx to the left list of options of the configuration window.
  65.   » Scroll the Scripts list on the right until you see
  66.     'When reading a message' option, then click on it.
  67.   » Find the file using the Script gadget at the bottom,
  68.     the string gadget must show: YAM:Rexx/YAMhtml.yam
  69.   » Choose Arexx in the cycle gadget.
  70.   » It seems to work fine regardless of the 'Wait for termination'
  71.     checkbox  perhaps it is better to check it, just try it.
  72.   » 'Open console window' checkbox may remain unchecked.
  73.   » Click on Save.
  74.   » Done
  75. 2)
  76.   » Copy the file YamHtml.yam into the Rexx directory inside YAM:.
  77.   » Start YAM and press Config button or select Configuration on the Settings menu.
  78.   » Click on Arexx to the left list of options of the configuration window.
  79.   » Look for the first free 'Scripts' menu entry (written in black are free)
  80.     then click on it.
  81.   » Find the file using the Script gadget at the bottom,
  82.     the string gadget must show: YAM:Rexx/YAMhtml.yam .
  83.   » Write YAMhtml in the 'Name' string gadget.
  84.   » Choose Arexx in the cycle gadget.
  85.   » It seems to work fine regardless of the 'Wait for termination'
  86.     checkbox  perhaps it is better to check it, just try it.
  87.   » 'Open console window' checkbox may remain unchecked.
  88.   » Click on Save.
  89.   » Done
  90.  
  91. Usage has been updated to 1.8.
  92. Usage:
  93. As there are two ways for installing it, there are two for using it too:
  94. Choosing the first installation method (preferred) the program automatically
  95. checks if there is an HTML document to be seen and, accorcing to the setting,
  96. asks you if you want or not see it as HTML or directly shows it up.
  97.  
  98. With the second method the program remains inactive until you call it by the
  99. Scripts menu.
  100.  
  101. Behavior has been updated to 1.7.
  102. Behavior:
  103. If an Amiga browser is running (AWeb,IBrowse or Voyager) the program uses it,
  104. otherwise it will ask you to choose one. (This only once in an Amiga session).
  105. If an Amiga browser is not running and you have been asked once to open one,
  106. the program reopen the browser you had first choosen.
  107. But if you,in the meantime, have changed your mind, you may change your browser
  108. by closing the one you are using and opening a different one by hand.
  109. If you are on line with Genesis or Miami and one of the above browswrs is running
  110. the script will let the browser to get the doc. related pictures from the net.
  111. The script now put the browsers window (for AWeb the screen too) to the front
  112. exept for IBrowse and Voyager: This two puts a new window to the front if the
  113. variable NewWind in line 7 of the script is set to "YES".
  114. 1.7a Note: The NewWind="YES" variable now controls the opening of a new window
  115.            with AWeb also.
  116. In this version, 1.7, I decided to cut off the option to start Voyager
  117. from the prog. bacause it crashes my machine on starting Voyager,
  118. precisely while loading cookies, I tried to take the piece of
  119. code that does the job and run it as an Arexx macro from the shell
  120. and it opens V nicely. It's unbelievable ,I can not understand.
  121. Nevertheless, you may use V by starting it manually.
  122. I think that V, at this stage, is a bit unreliable yet.
  123. Please, read the beginning of this doc. on how to set the browsers paths and
  124. names.
  125.  
  126. Sideffect:
  127. Exiting Yam the script leaves a directory inside T: containing the last shown
  128. document. It is not annoying to me but it is easy cure by writing a small ADOS
  129. batch to be run on leaving Yam. If you want you may e-mail me about this and
  130. for bug reports, thank you.
  131. 1.7 Note:
  132. I enclose now a little Arexx to put on "Program Termination" of the Yam arexx
  133. configuration (if you wish) .It will delete the last shown doc and the dir in T: .
  134.  
  135. Law:
  136. This script is freeware and I, the author, will NOT be responsible if this
  137. script or its misuse may cause any damage whatsoever.
  138.